home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / Text and Speech / Writeswell Jr / Writeswell Jr. Instructions < prev   
Text File  |  1993-03-08  |  12KB  |  359 lines

  1. Writeswell Jr. Version 1.0.2
  2. December 30, 1992
  3.  
  4. _____________
  5. Illustrated instructions follow.
  6. _____________
  7.  
  8. Writeswell Jr. will be frequently upgraded and new features added.  To receive notification of upgrades please register by sending us your name and address!
  9.  
  10. A future version will handle pictures so you don't have to read this with TeachText.
  11.  
  12. _____________
  13.  
  14. Version 1.0.2:
  15. Added a new feature - if Spellswell 7 or Spellswell 7 Demo is in the same folder the -first- time Writeswell Jr. runs it is installed in the Services menu automatically.  To cause this to happen, throw away the Writeswell Jr. Preferences file, found in the Preferences forler which is in the System Folder.
  16.  
  17. Fixed scroll bar bug.
  18. Fixed bug with Cancel from Print dialog.
  19.  
  20. _____________
  21. Writeswell Jr. is a product of:
  22.  
  23. Working Software, Inc.
  24. 740 Front Street, #318
  25. Santa Cruz, CA 95060
  26.  
  27. Mail to:
  28. P.O. Box 1844
  29. Santa Cruz, CA 95061-1844
  30.  
  31. Sales Dept., for orders: 800-229-9675
  32. VOICE: (408) 423-5696
  33. FAX: (408) 423-5699
  34.  
  35. Electronic Mail Addresses:
  36.  
  37. AppleLink:  D0140
  38.  
  39. Working Software has a customer service area on CompuServe.  From any CompuServe prompt, type GO MACBVEN (Apple Vendor's Forum B).  Leave messages in section 10 of MACBVEN, or send private messages to 76004,2072.
  40.  
  41. Working Software maintains a forum on America Online.  Our forum keyword is WORKING.  You may also send private messages to screen name WORKINGSW.
  42.  
  43. Internet:  76004.2072@compuserve.com
  44.  
  45. _____________
  46.  
  47. Writeswell Jr. is a -free- Apple Events mini-word-processor/text-editor with font and style menus.  It opens, saves and prints text documents.  Copy it to your computer.  Please register with Working Software to receive updates and our newsletter "Hard Working Times."
  48.  
  49. Writeswell Jr.'s "Services" menu allows you to add any and all "services" that use Apple Events Word Services.  These services are programs the work with the text in your document, such as spelling and grammar checkers, hyphenators, envelope addressers, and anything else that software developers can think up.  If these programs work with Apple Events Word Services, they can be added to Writeswell Jr.'s Services menu.
  50.  
  51. Please register with Working Software to receive updates and information about "Services" that work with Writeswell Jr.
  52.  
  53. -----
  54.  
  55. This Writeswell Jr. READ ME file contains operation instructions for the Writeswell Jr. program.  We have divided this file into the following sections:
  56.  
  57. –Attention Users!!_
  58. _What is Writeswell Jr.?_
  59. _IAC, Apple Events, and Word Services_
  60. _Using Writeswell Jr._
  61. _Apple Events Word Services_
  62. _Adding a Service To Writeswell Jr._
  63. _Removing a Service From Writeswell Jr._
  64. _Other Writeswell Jr. Information_
  65. _Writeswell Jr. Source Code Available_
  66. _How To Contact Working Software_
  67. _Copying and Distributing_
  68.  
  69. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  70. –Attention Users!!_
  71.  
  72. Writeswell Jr. is free.  Please register your copy with Working Software by U.S. Mail or via an electronic mail service.  We support registered owners with notices of upgrades and the Working Software newsletter, _The Hard Working Times_.
  73.  
  74. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  75. _What is Writeswell Jr.?_
  76.  
  77. Writeswell Jr. is a “mini” word processor that does something very special (on Macs running System 7).  It could blow all those big, klunky, memory-guzzling word-processing programs out of the water.
  78.  
  79. WRITESWELL JR. DEMONSTRATES THE “WORD SERVICES” APPLE EVENT SUITE!!!!
  80.  
  81. We call Writeswell Jr. a “mini” word processor, and we mean MINI.  No ruler, no tabs, no pictures.  Definitely no spreadsheets (hey...  it's free!).
  82.  
  83. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  84. _IAC, Apple Events, and Word Services_
  85.  
  86. System 7 includes something called Inter-Application Communication (IAC) which allows separate programs to communicate with each other while running.  Because of this communication ability, software publishers can break large programs into smaller parts (or modules) that operate as separate programs.  The separate programs can appear to operate as a single program.
  87.  
  88. Certain IAC messages that applications send to each other are called Apple Events.  One program might send an Apple Event telling a receiving program to perform a certain task.  After performing the task, the receiving program can return an Apple Event to the first program.  One kind of Apple Event might be an instruction to send text from a word processor to a spelling checker.
  89.  
  90. Working Software, Inc. developed a specific set of Apple Events for programs that process text, named the “Word Services” Apple Event Suite.  Apple Computer, Inc. has endorsed the Word Services Suite as the industry standard.
  91.  
  92. The Word Services Apple Event Suite defines a standard language that Macintosh text processing applications use to communicate with one another.  Any Macintosh application that includes the Word Services Suite can use any external spelling or grammar checker, hyphenator, or other text-editing utility that uses the Word Services Suite as if the utility is built into the application itself.
  93.  
  94. Writeswell Jr. is a “Word Services” application.  Working Software, Inc’s Spellswell 7 spelling checker is a “Word Service”.
  95.  
  96. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  97. _Using Writeswell Jr._
  98.  
  99. 1.  Copy Writeswell Jr. onto your Hard Disk.
  100. Drag the Writeswell Jr. icon over your Hard Disk icon until the Hard Disk icon highlights and release the mouse button.
  101.  
  102.  
  103.  
  104.  
  105.  
  106. 2.  Double-click the Writeswell Jr. icon to open the Writeswell Jr. program.
  107. A window, named “New Window” opens.  You can type anything you want.  You can change fonts and styles.  You can even Save your documents and Print them.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124. If you do not have System 7, please do not fret.  You can use Writeswell Jr. as a “mini” word-processor for simple documents, for taking notes, for examining text files, or even for practicing your Macintosh skills.
  125. Please enjoy your free gift from us.
  126.  
  127. If you have System 7, please continue.  You can add Spellswell 7 (or any other “Word Service”) as a built-in menu item to check your documents.
  128.  
  129. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  130. _Apple Events Word Services_
  131.  
  132. Mighty Disclaimer!!!  In order to take advantage of Writeswell Jr’s “Word Services” feature, you must have System 7 installed on your Macintosh.  Writeswell Jr. contains the Word Services technology.  Any service program (that you wish to install in the Services menu of Writeswell Jr.) must ALSO have this capability.  By “service” we mean spelling or grammar checker, hyphenator, or other text processing utility.
  133.  
  134. +++++++++++
  135. Unsure if your favorite program supports Word Services yet?
  136. Please contact the publisher of your program and ask.
  137. +++++++++++
  138.  
  139. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  140.  
  141. _Adding a Service To Writeswell Jr._
  142.  
  143. This section provides specific instructions for adding a Check Spelling menu item (Spellswell 7) to Writeswell Jr.  If you want to add a different “Word Service” to Writeswell Jr., just insert the name of the other program everywhere you see “Spellswell 7”.  For more information about Spellswell 7 or if you want to purchase Spellswell 7, please contact Working Software at the address listed below.
  144.  
  145. 1.  To add “Check Spelling” (or other word service command) to the Services menu of Writeswell Jr., first double-click the Spellswell 7 icon.
  146.  
  147. 2.  Double-click Writeswell Jr’s icon to open Writeswell Jr.
  148.  
  149. 3.  A blank window named “New Window” opens.
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163. 4.  Type the sentence, “This is a teset.” 
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178. (This user got carried away a bit.)
  179.  
  180. 5.  Choose Get New Service from the Services menu.
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188. 6.  When the Program-to-Program Communication (PPC) Browser appears, highlight the name Spellswell 7 and click OK.
  189.  
  190. System 7’s Program-to-Program-Communication Browser (shown below) tells you what Macintosh computers are in your local network, which AppleTalk Zones you can access, and how many Apple Event Aware Programs are open.  Read the “Chooser” and “Network” sections of your Macintosh Manuals for information about networks and zones.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212. Now, Writeswell Jr. should have a Check Spelling menu item.  Once you have added this menu item, Writeswell Jr. remembers to open Spellswell 7 when you choose the Check Spelling menu item (unless you do something silly, like throw Spellswell 7 in the Trash).
  213.  
  214. 7.  Check the spelling of your Writeswell Jr. test document by choosing the Check Spelling menu item.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223. Writeswell Jr. sends an “Apple Event” to Spellswell 7.  This Apple Event instructs Spellswell 7 to get the text out of the Writeswell Jr. document and spell-check it.  Writeswell Jr. and Spellswell 7 operate (seamlessly and modularly) as if they are the same program.  You cannot tell that two separate programs are processing your text.  That is the beauty of the Apple Events “Word Services” Suite.
  224.  
  225. Note - If your “Word Service” utility’s dialog hides the Writeswell Jr. window, then drag the “Word Service” utility’s dialog or Writeswell Jr’s window around the screen until you can view them both.  (Click the title bars to drag the windows around the screen.)
  226.  
  227. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  228. _Removing a Service From Writeswell Jr._
  229.  
  230. These instructions demonstrate removal of the service called “Acme Hyphenator”.
  231.  
  232. 1.  Choose Remove Service from the Services menu.
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245. 2.  When the Remove Service dialog appears, highlight the name of the service you want to remove.
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264. 3.  Click Remove.
  265.  
  266. 4.  Click Done.  
  267.  
  268. Now, the removed service no longer appears in the Services menu.
  269.  
  270. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  271. _Other Writeswell Jr. Information_
  272.  
  273. If you choose Options… from the Edit menu, you see the Programmer Options dialog.  The choices refer to the different ways “Word Services” programs can transfer text back and forth.
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  291. _Writeswell Jr. Source Code Available_
  292.  
  293. The source code for Writeswell Jr. is available through many electronic services and directly from Working Software, Inc.  This source code not only demonstrates the use of Apple Events, but also can teach programmers who are new to Macintosh development about menus, windows, file saving, printing, creation of Preferences files, dialogs, custom menus, scroll bars, and much more.
  294.  
  295. From America Online:
  296.  
  297. Enter the Macintosh Development Forum (use keyword “mdv” or “macdevelopment”).
  298. Click the Software Library Search button.
  299. Open the Developers Library
  300. Search for “Writeswell”
  301.  
  302. From CompuServe:
  303.  
  304. Look in the tools library of the Mac Developers Forum (GO MACDEV).  Use the browse command to search for keyword "writeswell".
  305.  
  306. From the Internet:
  307.  
  308. Download the sources via anonymous ftp from sumex-aim.stanford.edu.  The Writeswell Jr. sources are in the file info-mac/sources/c/writeswell-jr.hqx
  309.  
  310. From AppleLink:
  311.  
  312. Download the file “Apple Events Word Services SDK”.  The path is:
  313.  
  314. Developer Support
  315.  Developer Services
  316.   Tools & Apps
  317.    OS/Toolbox
  318.     Apple Events
  319.  
  320. From the Apple Developer CD:
  321.  
  322. The Writeswell Jr. sources can be found by opening the following sequence of folders:   
  323.  
  324. Tools & Apps
  325.    OS/Toolbox
  326.     Apple Events
  327.      Word Services
  328.  
  329. Be sure your Apple Developer CD has version 1.0 or later of the Writeswell Jr. sources.  A preliminary version, 1.0d6, appeared on the CD starting in July 1992.
  330.  
  331. To receive a Writeswell Jr. Source Code disk by U.S. Mail, please send a $6 shipping & handling fee to cover the cost of the disk and shipping to the address listed below.
  332.  
  333. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  334. _How To Contact Working Software_
  335.  
  336. Working Software, Inc.
  337. P.O. Box 1844
  338. Santa Cruz, CA 95061-1844
  339.  
  340. VOICE: (408) 423-5696
  341. FAX: (408) 423-5699
  342.  
  343. Electronic Mail Addresses:
  344.  
  345. AppleLink:  D0140
  346.  
  347. Working Software has a customer service area on CompuServe.  From any CompuServe prompt, type GO MACBVEN (Apple Vendor's Forum B).  Leave messages in section 10 of MACBVEN, or send private messages to 76004,2072.
  348.  
  349. Working Software maintains a forum on America Online.  Our forum keyword is WORKING.  You may also send private messages to screen name WORKINGSW.
  350.  
  351. Internet:  76004.2072@compuserve.com
  352.  
  353. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  354. _Copying and Distributing_
  355.  
  356. Please feel free to copy the Writeswell Jr. program.  Be sure to register Writeswell Jr. with Working Software, Inc.  We support registered owners with notices of upgrades and the Working Software newsletter _Hard Working Times_.
  357.  
  358. ŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸŸ
  359.